home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1996 June / EnigmA AMIGA RUN 08 (1996)(G.R. Edizioni)(IT)[!][issue 1996-06][EARSAN CD VII].iso / earcd / utmisc2 / wrip_25.lha / WRip.doc < prev    next >
Text File  |  1996-05-12  |  6KB  |  169 lines
  1.  
  2.     $VER: WRip V2.5 (12.05.96)
  3.           ====================
  4.  
  5. Introducing
  6.   WRip is a CLI util which scans input data for known formats and save them.
  7.   The input can be a NDOS Disk or a normal file.
  8.  
  9.   
  10. Requirements
  11.   MC68020 or better (special 68000 version is also supplied)
  12.   Kickstart 2.05 (V37) or better
  13.   xfdmaster.library for decrunching files (optional)
  14.   enough ram (disks will completely loaded to ram)
  15.   harddisk (strongly recommend)
  16.  
  17.  
  18. Disclaimer
  19.   No warranties of any kind are made to the functionality of this
  20.   program. You are using it ENTIRE at your own risk.
  21.  
  22.  
  23. Installation
  24.   just copy WRip anywhere you like (e.g. C:)
  25.  
  26.  
  27. Using
  28.   - enter the directory where the ripped formats should stored (cd ...)
  29.     start WRip with input as argument (eg "WRip DF0:" or "WRip DH2:xyz.ab")
  30.      now WRip reads the disk or loads the file
  31.      then it scans the data
  32.      if a format is recognized it will saved in the actual directory, the name
  33.      of the file is "format start_offset_in_source end_offset_in_source"
  34.   - its recommend to integrate WRip in your DirUtil (eg DOpus)
  35.     I use the following buttons : "WRip DF0:" "WRip RAD:" "WRip file" ...
  36.   - while WRip is loading or searching, you can break it with CTRL-C
  37.   - WRip is PURE and can made resident
  38.   - see CLI-Convention for further details
  39.  
  40.  
  41. WRip knows the follwing formats :
  42.   - Executable files ($000003F3), IFF files (FORM)
  43.   - various pack formats (ATM5, BOND, CrM2, CrM!, FIRE, FVL0, GC!, ICE!, Ice!,
  44.     IMP!, LOB, LPv1, LZWH, PACK, PIco, PP20, RNC0, RNC1, RNC2, S300, S310,
  45.     S400, S401, S403, S404, SC, SF, SFHD, SP, SSUR, TPWM, XPKF) and some
  46.     clones (ATN!, CHFI, Z&G!, TSM!)
  47.   - if the option XFDSCAN is used the amount of detectable formats depends on
  48.     the xfdmaster.library
  49. WRip gives you a message if one of the following crunch-id's were found :
  50.   - BH, PX20, SA, SFCD, STC, "T.S "
  51.  
  52.  
  53. The CLI-Convention
  54.   - Template :
  55.     WRip INPUT/A,XFDSCAN/S,SD=SAVEDISK/S,SB=SAVEBOOTEXE/S,NE=NOEXE/S,
  56.          DEEP/S,AUTODEC/S,IGNOREERRORS/S,MU=MAXUNPACKED/K/N,
  57.          MR=MAXRATIO/K/N,TASKPRI/K/N
  58.  
  59.     INPUT/A        specify the data which will loaded
  60.             if it ends with ":" it is interpreted as a Device
  61.             otherwise as a file
  62.  
  63.     XFDSCAN/S    if selected WRip uses xfdmaster.library for scanning,
  64.             the internal search routines will be disabled, so
  65.             you can eighter scan with WRip or with XFD but not
  66.             with both at the same time
  67.             (for this operation xfdmaster.library V37 is required)
  68.  
  69.     SD=SAVEDISK/S    if WRip has read a disk (device), the whole disk will
  70.             saved as "BIN__FullDisk" after scan
  71.  
  72.     SB=SAVEBOOTEXE/S if WRip has read a disk the Bootblock will saved as
  73.             a standard amiga executable namely "EXE__BootBlock"
  74.  
  75.     NE=NOEXE/S    if specified WRip will not scan for Executables
  76.             makes sense if you scan an Executable and need no
  77.             duplication of them (hoho!)
  78.  
  79.     DEEP/S        select the DEEP mode
  80.             in normal mode the area of a saved format will skipped
  81.             (ie not scanned), in DEEP mode these areas will also
  82.             scanned (ie not skipped)
  83.  
  84.     AUTODEC/S    if specified WRip will try to decrunch each detected
  85.             format, if decrunching is successful the file will
  86.             saved with extension ".dec" otherwise it will saved
  87.             crunched
  88.             (for this operation xfdmaster.library V34 is required)
  89.  
  90.     IGNERRS/S    if specified WRip will not immediately quit if an error
  91.             occurs while diskloading, but the unreadable area in
  92.             memory is filled with the pattern "WRIP" and WRip skips
  93.             to the next track
  94.             can used to scan a disk with read/write errors ...
  95.  
  96.     MU=MAXUNPACKED/K/N with this option you can set the internal variable
  97.             with same name (e.g. ... MU=150000 ...)
  98.             for any packed file found, WRip will compare the
  99.             unpacked size of the file against MAXUNPACKED, if
  100.             MAXUNPACKED is lower the file won't saved
  101.             it makes no sense to save a file that is unpacked
  102.             50 MB or so...
  103.             lower values speeds up the PP20-trace !
  104.             default: MAXUNPACKED=2000000
  105.  
  106.     MR=MAXRATIO/K/N    set internal variable MAXRATIO
  107.             this var is only used in PP20-trace at the moment
  108.             the var describes how large the unpacked file can be
  109.             dependent on the size packed, or with other words :
  110.             "packedsize * MAXRATIO > unpackedsize" must be true
  111.             otherwise the file won't saved
  112.             higher values than default will dramatically slow down
  113.             the trace-mode (see chapter PP20-trace)
  114.             default: MAXRATIO=4 (useful values 2...10)
  115.  
  116.     TASKPRI/K/N    with this option you can set the taskpriority of the
  117.             scanroutine, this is useful if you have a PP20-trace
  118.             which will take a long time, and want to do some
  119.             other things with your machine
  120.             default: TASKPRI=-3 (allowed values -10...10)
  121.  
  122.  
  123. PP20 trace-mode
  124.   - to rip PowerPacker files a special trace mode is used
  125.   - if a "PP20" ID will found WRip swiches to trace mode
  126.     the trace-mode will stopped if :
  127.       a valid PP20-file will recognized and saved
  128.       the next "PP20" ID will found
  129.       the end of file is reached
  130.       the user press CTRL-C (quits only the PP20-trace, must pressed again to
  131.       leave the program)
  132.   - important for the speed of the trace mode are the value of MAXUNPACKED
  133.     and MAXRATIO
  134.     e.g. if you want to rip a soundfile you can set MAXRATIO=2 because
  135.     PowerPacker is not able to compress real samples better than faktor 2
  136.     (gain « 50%)
  137.     see also CLI-Convention
  138.  
  139.  
  140. Other related Programms
  141.   - for decrunching the XFD-package (aminet:util/pack/xfd113.lha) is
  142.     recommend
  143.   - a good program for ripping soundmodules is ExoticRipper
  144.     (aminet:mus/misc/ExoticRip229.lha)
  145.  
  146.  
  147. Bugs
  148.   - files saved can be corrupt because only ID and sizes are checked
  149.     (except CMP1,PP20,SSUR,TPWM they are always 100% clean)
  150.     the further process of corrupted files can crash other progs/your machine!
  151.   - not a bug :    never try to scan a FileSystemFormatted-Disk (resulting files
  152.         are waste, what else)
  153.  
  154.     
  155. Future plans
  156.   - nothing, I think this is the last release
  157.  
  158.  
  159. Contact me for bugs, improvements, comments, new formats ...
  160.  
  161. EMail:    jah@hrz.th-zwickau.de
  162. WWW:    http://www.th-zwickau.de/~jah/
  163. Mail:    Bert Jahn
  164.     Franz-Liszt-Straße 16
  165.     Rudolstadt
  166.     07407
  167.     Germany
  168.  
  169.